Foxit PDF SDK
FoxitPDFSDKPython2.XFADoc类 参考
类 FoxitPDFSDKPython2.XFADoc 继承关系图:
FoxitPDFSDKPython2.Base

Public 成员函数

def XFADoc (document)
 构造函数。
更多...
 
def XFADoc (other)
 构造函数,使用另一个 XFA 文档对象。
更多...
 
def ExportData (output_file_path, export_type)
 将数据导出到文件。
更多...
 
def FlattenTo (output_file_path)
 将当前 XFA 文档扁平化到文件。
更多...
 
def FlattenTo (stream)
 将当前 XFA 文档扁平化到文件流。
更多...
 
def GetPage (page_index)
 按索引获取 XFA 页面。
更多...
 
def GetPageCount ()
 获取 XFA 页面数量。
更多...
 
def GetType ()
 获取 XFA 文档类型。
更多...
 
def GetWidgetByFullName (full_name)
 获取与指定全名匹配的 XFA 控件。
更多...
 
def ImportData (file_path)
 从 XML 或 XDP 文件导入数据。
更多...
 
def ImportData (file_reader)
 FoxitPDFSDKPython2.FileReaderCallback 对象导入数据。
更多...
 
def IsEmpty ()
 检查当前对象是否为空。
更多...
 
def KillFocus ()
 取消 XFA 控件的焦点。
更多...
 
def ProcessEvent (event_type)
 为当前 XFA 文档中的所有 XFA 控件处理某种事件。
更多...
 
def ResetForm ()
 重置表单。
更多...
 
def SetDocProviderCallback (doc_provider_callback)
 设置 XFA 文档提供程序回调。
更多...
 
def SetFocus (xfa_widget)
 设置 XFA 控件的焦点。
更多...
 
def SetPDFPath (pdf_file_path)
 设置相关 PDF 文档的路径。
更多...
 
def StartLoad (pause)
 开始为当前 XFA 文档加载内容。
更多...
 

静态 Public 属性

 e_Dynamic = _fsdk.XFADoc_e_Dynamic
 XFA 文档类型:动态。

 
 e_EventTypeCalculate = _fsdk.XFADoc_e_EventTypeCalculate
 此类事件代表计算操作。

 
 e_EventTypeChange = _fsdk.XFADoc_e_EventTypeChange
 此类事件在改变表单域值时触发。

 
 e_EventTypeClick = _fsdk.XFADoc_e_EventTypeClick
 此类事件在域中点击时触发。

 
 e_EventTypeDocClose = _fsdk.XFADoc_e_EventTypeDocClose
 此类事件仅当所有验证成功时,在处理过程的最后阶段触发。

 
 e_EventTypeDocReady = _fsdk.XFADoc_e_EventTypeDocReady
 此类事件在文档渲染之前、数据绑定之后触发。

 
 e_EventTypeEnter = _fsdk.XFADoc_e_EventTypeEnter
 此类事件在字段获得键盘焦点时触发,无论是由用户操作(通过 Tab 键跳入字段或鼠标点击) 还是通过脚本以编程方式设置焦点所引起。preSubmit 事件仅适用于表单 DOM($form)。

 
 e_EventTypeExit = _fsdk.XFADoc_e_EventTypeExit
 此类事件在键盘焦点从子表单内直接或间接地转移到子表单外的字段或其他对象时触发。

 
 e_EventTypeFull = _fsdk.XFADoc_e_EventTypeFull
 此类事件在用户已向字段输入允许的最大内容量并试图输入更多内容时触发。

 
 e_EventTypeIndexChange = _fsdk.XFADoc_e_EventTypeIndexChange
 此类事件用于通知对象它刚刚被添加到数组中,或其数组中的位置(下标)已发生变化。

 
 e_EventTypeInitCalculate = _fsdk.XFADoc_e_EventTypeInitCalculate
 此类事件代表首次运行计算。

 
 e_EventTypeInitVariables = _fsdk.XFADoc_e_EventTypeInitVariables
 此类事件并非实际的事件活动,仅表示变量中的脚本签名。

 
 e_EventTypeMouseDown = _fsdk.XFADoc_e_EventTypeMouseDown
 此类事件在鼠标按钮被按下且鼠标指针位于区域内的时刻触发。

 
 e_EventTypeMouseEnter = _fsdk.XFADoc_e_EventTypeMouseEnter
 此类事件在用户将鼠标指针移入字段区域时触发,无需按下鼠标按钮。

 
 e_EventTypeMouseExit = _fsdk.XFADoc_e_EventTypeMouseExit
 此类事件在用户将鼠标指针移出字段时触发,无论鼠标按钮是否被按下。

 
 e_EventTypeMouseUp = _fsdk.XFADoc_e_EventTypeMouseUp
 此类事件在鼠标按钮被释放且鼠标指针位于区域内的时刻触发。

 
 e_EventTypePostExecute = _fsdk.XFADoc_e_EventTypePostExecute
 此类事件在成功的 WSDL 事务后触发,即在收到请求的回复且接收的数据已编组到连接数据 DOM 之后。

 
 e_EventTypePostOpen = _fsdk.XFADoc_e_EventTypePostOpen
 此类事件与下拉选择列表的打开前事件相关。

 
 e_EventTypePostPrint = _fsdk.XFADoc_e_EventTypePostPrint
 此类事件在渲染的表单已发送到打印机、后台打印程序 或输出目标后触发。

 
 e_EventTypePostSave = _fsdk.XFADoc_e_EventTypePostSave
 此类事件在表单以 PDF 或 XDP 格式写出后立即触发。

 
 e_EventTypePostSign = _fsdk.XFADoc_e_EventTypePostSign
 此类事件在成功应用签名后触发。

 
 e_EventTypePostSubmit = _fsdk.XFADoc_e_EventTypePostSubmit
 此类事件在返回数据已编组到连接数据 DOM 后立即触发。

 
 e_EventTypePreExecute = _fsdk.XFADoc_e_EventTypePreExecute
 此类事件在通过 WSDL 向 Web 服务发送请求时触发,即在数据已编组到连接数据 DOM 之后,但请求发送之前。

 
 e_EventTypePreOpen = _fsdk.XFADoc_e_EventTypePreOpen
 此类事件仅适用于 open="userControl" 或 open="onEntry" 的下拉选择列表。 该事件旨在触发用于向选择列表添加选项或从中移除选项的脚本。

 
 e_EventTypePrePrint = _fsdk.XFADoc_e_EventTypePrePrint
 此类事件在打印渲染开始前触发。

 
 e_EventTypePreSave = _fsdk.XFADoc_e_EventTypePreSave
 此类事件在表单数据以 PDF 或 XDP 格式写出之前触发。

 
 e_EventTypePreSign = _fsdk.XFADoc_e_EventTypePreSign
 此类事件在即将应用签名时触发。

 
 e_EventTypePreSubmit = _fsdk.XFADoc_e_EventTypePreSubmit
 此类事件在数据已编组到连接数据 DOM 之后,但在验证之前以及数据提交到主机之前触发。

 
 e_EventTypeReady = _fsdk.XFADoc_e_EventTypeReady
 此类事件在 XFA DOM 完成加载后触发。

 
 e_EventTypeUnknown = _fsdk.XFADoc_e_EventTypeUnknown
 事件类型:未知。

 
 e_EventTypeValidate = _fsdk.XFADoc_e_EventTypeValidate
 此类事件代表验证操作。

 
 e_EventTypeValidationState = _fsdk.XFADoc_e_EventTypeValidationState
 此类事件在目标的验证状态发生变化时触发。

 
 e_ExportDataTypeStaticXDP = _fsdk.XFADoc_e_ExportDataTypeStaticXDP
 导出数据类型:静态 XDP。

 
 e_ExportDataTypeXDP = _fsdk.XFADoc_e_ExportDataTypeXDP
 导出数据类型:XDP。

 
 e_ExportDataTypeXML = _fsdk.XFADoc_e_ExportDataTypeXML
 导出数据类型:XML。

 
 e_Static = _fsdk.XFADoc_e_Static
 XFA 文档类型:静态。

 
 e_XDP = _fsdk.XFADoc_e_XDP
 XFA 文档类型:XDP,作为原始 XML 数据。

 

详细描述

XFADoc 从已加载的 PDF 文档对象构造,以便更清晰地访问 XFA 内容。 用户必须在使用 XFA 模块之前调用 FoxitPDFSDKPython2.Library.RegisterXFAAppProviderCallback 。 对于新构造的 XFA 对象,请记住在使用 XFA 类中的其他函数之前调用函数 FoxitPDFSDKPython2.XFADoc.StartLoad
要在 XFA 文档中搜索,请使用 XFADoc 对象构造 FoxitPDFSDKPython2.TextSearch 对象。

参见
FoxitPDFSDKPython2.TextSearch

构造及析构函数说明

◆ XFADoc() [1/2]

def FoxitPDFSDKPython2.XFADoc.XFADoc (   document)

构造函数。

当通过此构造函数成功构造 XFADoc 时,用户必须通过函数 FoxitPDFSDKPython2.XFADoc.SetDocProviderCallback 设置 XFA 文档提供程序回调。

参数
[in]documentA valid PDF document. It should has been loaded successfully.
注解
如果在函数 FoxitPDFSDKPython2.Library.Initialize 中使用的许可信息中未定义模块"XFA", 这意味着用户无权使用 XFA 相关函数,此构造函数将抛出异常 FoxitPDFSDKPython2.e_ErrNoXFAModuleRight

◆ XFADoc() [2/2]

def FoxitPDFSDKPython2.XFADoc.XFADoc (   other)

构造函数,使用另一个 XFA 文档对象。

参数
[in]other另一个 XFA 文档对象。

成员函数说明

◆ ExportData()

def FoxitPDFSDKPython2.XFADoc.ExportData (   output_file_path,
  export_type 
)

将数据导出到文件。

将数据导出到 FoxitPDFSDKPython2.FileWriterCallback 对象。

参数
[in]output_file_path数据将导出到的文件路径。
[in]export_type导出类型。请参考从 FoxitPDFSDKPython2.XFADoc.e_ExportDataTypeXML 开始的值,这应该是这些值之一。
返回
true 表示成功,false 表示失败。
参数
[in]stream由用户实现的 foxit::common::file::WriterCallback 对象,用于保存导出的数据。
[in]export_type导出类型。请参考从 FoxitPDFSDKPython2.XFADoc.e_ExportDataTypeXML 开始的值,这应该是这些值之一。
返回
true 表示成功,false 表示失败。

◆ FlattenTo() [1/2]

def FoxitPDFSDKPython2.XFADoc.FlattenTo (   output_file_path)

将当前 XFA 文档扁平化到文件。

参数
[in]output_file_path扁平化结果将保存到的文件路径。
返回
无。

◆ FlattenTo() [2/2]

def FoxitPDFSDKPython2.XFADoc.FlattenTo (   stream)

将当前 XFA 文档扁平化到文件流。

参数
[in]stream用户实现的 FoxitPDFSDKPython2.StreamCallback 对象,用于保存扁平化结果。
返回
无。

◆ GetPage()

def FoxitPDFSDKPython2.XFADoc.GetPage (   page_index)

按索引获取 XFA 页面。

参数
[in]page_index页面索引。有效范围:从 0 到 (count-1)。 count 由函数 FoxitPDFSDKPython2.XFADoc.GetPageCount 返回。
返回
XFA 页面。

◆ GetPageCount()

def FoxitPDFSDKPython2.XFADoc.GetPageCount ( )

获取 XFA 页面数量。

返回
页面数量。

◆ GetType()

def FoxitPDFSDKPython2.XFADoc.GetType ( )

获取 XFA 文档类型。

返回
XFA 文档的类型。请参考从 FoxitPDFSDKPython2.XFADoc.e_Dynamic 开始的值, 这将是这些值之一。

◆ GetWidgetByFullName()

def FoxitPDFSDKPython2.XFADoc.GetWidgetByFullName (   full_name)

获取与指定全名匹配的 XFA 控件。

某些 XFA 控件可能跨越多个 XFA 页面。在这种情况下,此函数只能用于 获取 XFA 文档中第一个匹配的 XFA 控件。用户也可以使用函数 FoxitPDFSDKPython2.XFAPage.GetWidgetByFullName 来获取 XFA 页面中匹配的 XFA 控件。

参数
[in]full_nameXFA 控件的全名。它不应该是空字符串。 XFA 控件的全名可以通过函数 FoxitPDFSDKPython2.XFAWidget.GetName 使用类型 FoxitPDFSDKPython2.XFAWidget.e_WidgetNameTypeFullName 在之前的过程中检索。
返回
XFA 控件对象。

◆ ImportData() [1/2]

def FoxitPDFSDKPython2.XFADoc.ImportData (   file_path)

从 XML 或 XDP 文件导入数据。

参数
[in]file_path源文件的路径,其数据将导入到当前 XFA 文档。 它应该是 XML 或 XDP 文件,文件扩展名应该是".xml"或".xdp"。
返回
true 表示成功,false 表示失败。

◆ ImportData() [2/2]

def FoxitPDFSDKPython2.XFADoc.ImportData (   file_reader)

FoxitPDFSDKPython2.FileReaderCallback 对象导入数据。

参数
[in]file_readerFoxitPDFSDKPython2.FileReaderCallback 对象,其数据将导入到当前 XFA 文档。 它应该是 XML 或 XDP 文件。
返回
true 表示成功,false 表示失败。

◆ IsEmpty()

def FoxitPDFSDKPython2.XFADoc.IsEmpty ( )

检查当前对象是否为空。

当前对象为空时,表示当前对象无用。

返回
true 表示当前对象为空,false 表示不为空。

◆ KillFocus()

def FoxitPDFSDKPython2.XFADoc.KillFocus ( )

取消 XFA 控件的焦点。

返回
无。

◆ ProcessEvent()

def FoxitPDFSDKPython2.XFADoc.ProcessEvent (   event_type)

为当前 XFA 文档中的所有 XFA 控件处理某种事件。

参数
[in]event_type事件类型。请参考从 FoxitPDFSDKPython2.XFADoc.e_EventTypePostPrint 开始的值,这应该是这些值之一,除了 FoxitPDFSDKPython2.XFADoc.e_EventTypeUnknown
返回
无。

◆ ResetForm()

def FoxitPDFSDKPython2.XFADoc.ResetForm ( )

重置表单。

返回
无。

◆ SetDocProviderCallback()

def FoxitPDFSDKPython2.XFADoc.SetDocProviderCallback (   doc_provider_callback)

设置 XFA 文档提供程序回调。

参数
[in]doc_provider_callback由用户实现并基于回调类 DocProviderCallback 的 XFA 文档提供程序回调对象。 它不应该为 null。用户应确保此回调对象在相关 PDF 文档释放之前保持有效。
返回
无。

◆ SetFocus()

def FoxitPDFSDKPython2.XFADoc.SetFocus (   xfa_widget)

设置 XFA 控件的焦点。

参数
[in]xfa_widget将获得焦点的 XFA 控件。
返回
无。

◆ SetPDFPath()

def FoxitPDFSDKPython2.XFADoc.SetPDFPath (   pdf_file_path)

设置相关 PDF 文档的路径。

PDF 路径将在函数 FoxitPDFSDKPython2.XFADoc.ExportData 中使用,作为导出数据的一部分。

参数
[in]pdf_file_path相关 PDF 文档的文件路径。它可以是绝对路径或 相对路径。不应该是空字符串。
返回
无。

◆ StartLoad()

def FoxitPDFSDKPython2.XFADoc.StartLoad (   pause)

开始为当前 XFA 文档加载内容。

加载 XFA 内容可能需要很长时间,因此此函数使用渐进过程来 执行此操作。
相关的 PDF 文档对象已加载,但只加载了 PDF 相关内容。 因此,为了访问 XFA 内容,应调用此函数来加载 XFA 内容。

参数
[in]pause暂停对象,决定导入过程是否需要暂停。 这可以是 null,表示在解析过程中不暂停。 如果不是 null,它应该是用户实现的有效暂停对象。 默认值:null
返回
渐进对象。请通过函数 FoxitPDFSDKPython2.Progressive.GetRateOfProgress 检查当前进度的比率。 如果比率还不是 100,请调用函数 FoxitPDFSDKPython2.Progressive.Continue 继续进度,直到进度完成。